---
title: User groups
---

import {Steps, TabItem, Tabs} from "@astrojs/starlight/components";

import FlattenedSteps from "../../components/FlattenedSteps.astro";
import NavigationSteps from "../../components/NavigationSteps.astro";
import CloudPaidPlansOnly from "../include/_CloudPaidPlansOnly.mdx";
import UserGroupsApplications from "../include/_UserGroupsApplications.mdx";
import UserGroupsIntro from "../include/_UserGroupsIntro.mdx";

import SubscriberCheckIcon from "~icons/zulip-icon/subscriber-check";
import SubscriberPlusIcon from "~icons/zulip-icon/subscriber-plus";

<CloudPaidPlansOnly />

<UserGroupsIntro />

<UserGroupsApplications />

You can add a group to another user group, making it easy to express your
organization's structure in Zulip's permissions system.

## Browse and join user groups

<Tabs>
  <TabItem label="Desktop/Web">
    <FlattenedSteps>
      <NavigationSteps target="relative/group/all" />

      1. Scroll through the list of user groups. You can use the **search box** near
         the top of the menu to filter the list by group name or description.
      1. Click the **join group** (<SubscriberPlusIcon class="zulip-unplugin-icon subscriber-plus-icon" />) icon to the left of a user group to
         join the group, if you have
         [permission](/help/manage-user-groups#configure-group-permissions) to do so.
    </FlattenedSteps>
  </TabItem>
</Tabs>

## Leave a group

<Tabs>
  <TabItem label="Desktop/Web">
    <FlattenedSteps>
      <NavigationSteps target="relative/gear/group-settings" />

      1. Click the **leave group** (<SubscriberCheckIcon class="zulip-unplugin-icon subscriber-check-icon" />) icon to the left of a user group to leave the
         group, if you have
         [permission](/help/manage-user-groups#configure-group-permissions) to do so.
    </FlattenedSteps>
  </TabItem>
</Tabs>

## View a group's card

<Tabs>
  <TabItem label="Desktop/Web">
    <Steps>
      1. Click on a user group mention in a message to open the **group card**.
    </Steps>
  </TabItem>
</Tabs>

## Related articles

* [Mention a user or group](/help/mention-a-user-or-group)
* [View group members](/help/view-group-members)
* [Create user groups](/help/create-user-groups)
* [Manage user groups](/help/manage-user-groups)
* [Moving to Zulip](/help/moving-to-zulip)
* [User roles](/help/user-roles)
